home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 2.iso / ACORNUSERS / EMULATOR / SEGA / !Sega / !Help < prev    next >
Text File  |  1997-08-03  |  19KB  |  428 lines
  1. THE LONGEST RUNNING REGULARLY UPDATED ACORN WWW MAGAZINE: 32-bit Acorn Gaming
  2.                                            http://www.doggysoft.co.uk/gaming/
  3.                                            
  4.  
  5. -----------------------------------------------------------------------------
  6.  
  7. !Sega version 0.71 (3rd August 1997)
  8. ~~~~~~~~~~~~~~~~~~
  9.  
  10. This text file gives a brief introduction to the !Sega emulator. It is split
  11. into a few different sections so that you only need to read the bits which
  12. interest you:
  13.  
  14. 1) Overview - what this program does
  15. 2) Basic operation - getting started
  16. 3) Advanced operation - Things you don't _need_ to know about, but might want
  17.                         to use anyway
  18. 4) MasterGear - more details about this portable emulator
  19. 5) Known bugs in this version
  20. 6) History - details of changes between this and previous versions
  21. 7) Copyright and Disclaimer
  22.  
  23. -----------------------------------------------------------------------------
  24.  
  25. 1) Overview
  26. ~~~~~~~~~~~
  27. !Sega is an emulator for Sega's Game Gear and Master System consoles, capable
  28. of running over 95% of the games available for these platforms. Games for the
  29. emulators must be supplied in a ROM file, which is a file image of the ROM
  30. which was in the relevant original game cartridge.
  31.  
  32. This emulator requires a Risc PC or later Acorn machine, including the A7000.
  33. If run on anything slower than a StrongARM processor then it will not run at
  34. full speed. It is roughly two and a half times to three times too slow on an
  35. ARM710 processor.
  36.  
  37. There are several places on the internet where such ROM cartridges can be
  38. downloaded from. You should try a web search or look at my 32-bit Acorn
  39. Gaming WWW pages (see address above) for possible sources. Note that it is
  40. illegal to be in the possession of copyrighted software without having
  41. permission to do so from the copyright holder - this means that it is illegal
  42. to possess virtually any ROM image when you do not own the original game
  43. itself (and even if you do the copyright conditions may exclude you from
  44. using anything other than the original cartridge itself). I personally own a
  45. Game Gear and many games, and use just these games on this emulator for
  46. testing, although since I do not have a StrongARM I do not actually use the
  47. emulator myself anyway.
  48.  
  49. Please do not email me asking for ROM images, for I will not do so under any
  50. circumstances. I do not condone software piracy.
  51.  
  52. !Sega consists almost entirely of an emulator written by Marat Fayzullin
  53. (fms@freeflight.com) called MasterGear, which I (Gareth Moore,
  54. glm20@cam.ac.uk) have ported to Acorn computers by providing graphics, sound
  55. and keyboard handlers, and writing a front-end for it. I have made a few
  56. changes to the code, so that it now strips copier headers from cartridges,
  57. and understands the Acorn filing system, but apart from this all code is by
  58. Marat, and it is he that deserves your appreciation for this emulator.
  59.  
  60. "Sega", "Master System" and "Game Gear" are registered trademarks of Sega
  61. Enterprises Limited. Neither I nor Marat are in any way associated with Sega.
  62. This emulator is completely unofficial. Also please note that Marat will not
  63. supply you with ROM images, either.
  64.  
  65.  
  66. -----------------------------------------------------------------------------
  67.  
  68. 2) Basic Operation
  69. ~~~~~~~~~~~~~~~~~~
  70. Before you can use the emulator at all you need to have the Acorn Toolbox
  71. installed on your system. This is a set of modules freely available from
  72. Acorn's FTP site (ftp.acorn.co.uk) which provide user-interface support
  73. libraries for all desktop programs to use. Instructions on what to do with
  74. them should come included no matter where you download them from. If you have
  75. RISC OS 3.6 or above then the Toolbox is a permanent part of your system, and
  76. you need not obtain anything extra in order to run this emulator.
  77.  
  78. Double-click !Sega to load this emulator. A loading announcement window will
  79. appear briefly - any mouse click or keyboard press should remove it, or you
  80. can wait for a few seconds. It doesn't stop operation of your computer,
  81. however, so you can just ignore it and leave it there until it goes away if
  82. you like.
  83.  
  84. The emulator will not do anything useful until you supply it with a ROM image
  85. file, so you'll need to obtain at least one of these. If it ends in ".gg",
  86. ".sms", "/gg" or "/sms" then it will be assumed to be either a Game Gear or
  87. Master System game respectively, but better still you should filetype the
  88. file to either 'SegaGG' or 'SegaSMS'. (Open a filer menu over the file and
  89. choose "File 'Whatever'" -> "Set type" -> ... and enter "SegaXXX" where XXX
  90. is either GG or SMS). Once filetyped you can just double-click a file to load
  91. it into the emulator, and it will have a 'Sega GG' or 'Sega SMS' picture
  92. representing it in your filer window. Note that your computer has to have
  93. "seen" the window with !Sega in before this will work, however. For further
  94. details about file operations and so forth see the Welcome and User Guides
  95. which came with your computer.
  96.  
  97. If you are viewing the ROM image files from a DOS disc then they will be
  98. automatically filetyped, as long as they have GG or SMS file extensions. If
  99. you are using SparkFS then add the lines:
  100. 0x0ad gg
  101. 0x0ae sms
  102. ...to the end of your !SparkFS.Config.Extensions file in order to make sure
  103. that most archived games you download will be filetyped automatically.
  104.  
  105.  
  106. Double-click a filetyped game, or drag one to the Sega icon on the iconbar.
  107. You will now be playing the game assuming all is well - use the keys
  108. described below or define your own (see later). To return to the desktop
  109. press the <ESCAPE> key, which will pause the game. To continue it select
  110. 'Continue game' from the Sega iconbar menu. This option will be greyed out if
  111. no game is currently paused. You can also select 'Kill emulator' to remove
  112. the current game, although this serves little practical purpose unless you
  113. wish to stop someone else continuing your game without quitting the entire
  114. program.
  115.  
  116. If you get funny colours or odd effects which you don't expect, try
  117. filetyping the game to make sure you are not trying to run a Game Gear game
  118. in Master System mode (or if it is already filetyped, check it is correct).
  119.  
  120. The game expects to find a 60Hz 320x480 mode to run in (Acorn define this
  121. mode as standard, so this should not be a problem).
  122.  
  123.  
  124. The default keys are as follows:
  125.  
  126.   Q          - left  (joypad 1)
  127.   W          - right (joypad 1)
  128.   P          - up    (joypad 1)
  129.   L          - down  (joypad 1)
  130.   [          - button 1 and button A on joypad 1
  131.   ]          - button 2 and button B on joypad 1
  132.   <SPACE>    - START button on Game Gear
  133.   Keypad 7   - left  (joypad 2)
  134.   Keypad 8   - right (joypad 2)
  135.   Keypad 9   - up    (joypad 2)
  136.   Keypad 6   - down  (joypad 2)
  137.   Keypad +   - button A on joypad 2
  138.   Keypad .   - button B on joypad 2
  139.   <INSERT>   - PAUSE button on Master System
  140.   <HOME>     - RESET button on Master System
  141.   <F1>       - select joypad 1
  142.   <F2>       - select joypad 2
  143.   (Note that both joypad keysets work on the Game Gear)
  144.  
  145.  
  146. Please note that the 'Save game' feature from the iconbar menu is not
  147. currently implemented.
  148.  
  149.  
  150. -----------------------------------------------------------------------------
  151.  
  152. 3) Advanced Operation
  153. ~~~~~~~~~~~~~~~~~~~~~
  154. [This section will be rewritten once the interface is complete.]
  155.  
  156. Three operations are currently implemented - full-screen mode, key
  157. redefinition and saving of SRAM (allowing you to save your current position
  158. when playing a game which lets you do this). Unimplemented options are either
  159. hidden or greyed out (you can see the missing options using !ResEd if you are
  160. so inclined).
  161.  
  162. The emulator can be reconfigured whilst you are playing a game if you choose
  163. to return to the desktop with <Escape>. Continue the game for your changes to
  164. take effect.
  165.  
  166. Redefining Keys
  167. ~~~~~~~~~~~~~~~
  168. This should be self-explanatory. Click with adjust on the iconbar icon, or
  169. choose 'Define keys' from the main window opened when you click on the
  170. iconbar icon with select.
  171.  
  172. Click on the key you wish to redefine and a new window opens describing the
  173. key you are about to redefine and waiting for a key press. At this point you
  174. can press literally any key on the keyboard and it will be defined as
  175. requested. The name of the key you chose is entered in the box (if it is
  176. incorrect this is because you do not have a standard Risc PC keyboard, but
  177. this does not matter because the name is for your information only) and from
  178. then on it will have replaced the previous key for the given action.
  179.  
  180. You can also use the mouse buttons if you so wish, and the left and right
  181. alt, ctrl and shift keys are distinguished between.
  182.  
  183. Full-screen mode
  184. ~~~~~~~~~~~~~~~~
  185. To run the emulator using the full-screen mode you must define full-screen
  186. modes of the following dimensions:
  187.  
  188. Game Gear: 160x288
  189. Master System: 264x384
  190.  
  191. Without these modes the emulator defaults to a 320x480 mode. In the 320x480
  192. mode the emulator _should_ run at the correct speed - in the full-screen
  193. modes it won't. If you only want to run games for one system full-screen then
  194. you need only define the relevant full-screen mode, not both.
  195.  
  196. Acorn's !MakeModes (available from ftp.acorn.co.uk) can be used to define
  197. suitable modes. I cannot offer any help with this - sorry (I simply don't
  198. have the time). I might suggest, however, that you only make adjustments with
  199. the ARROW BUTTONS, and NOT by typing in values. I find the program adjusts
  200. other values sensibly if you use the buttons, which it doesn't do when you
  201. directly enter values.
  202.  
  203. Once you have defined a suitable mode you should select the "Run full-screen"
  204. option in the main window. If no suitable mode is found when you attempt to
  205. run a game the emulator displays a warning and does not proceed with the
  206. game.
  207.  
  208. Saving SRAM
  209. ~~~~~~~~~~~
  210. Open the main window by clicking <Select> on the iconbar icon. In the "SRAM
  211. Storage" box is a toggle switch (to the left of a greyed-out text-entry
  212. icon). If you select this toggle switch then the current state of the game's
  213. SRAM will be saved when you either:
  214.  
  215. * Quit or kill the emulator, or
  216. * Return to the desktop whilst playing a game
  217.  
  218. The SRAM will be saved to the file you choose by dragging the icon to a
  219. suitable filer window as normal. Note, however, that the SRAM will only be
  220. saved _after_ the emulator has been started up with a game - no file is
  221. written immediately.
  222.  
  223. Alternatively, an existing file can be loaded in by double-clicking it or
  224. dragging it into the window (or to the iconbar icon) as normal. It is not
  225. possible to overwrite an existing SRAM file - if you choose a file which is
  226. already present then this will be loaded in as the SRAM for the given game
  227. (rather than a new file being created with the same name).
  228.  
  229. Note that you should only use SRAM files with the games that created them! If
  230. you use one with the wrong game it may well be overwritten by the new game's
  231. data, or the new game may object to the contents of the SRAM file.
  232.  
  233. As a safety measure, if you do _not_ choose the "SRAM Storage" option then
  234. the current SRAM state is written to a file in <Wimp$ScrapDir> called
  235. 'SegaSRAM' each time you return to the desktop. If you quit or kill the
  236. emulator it is removed, however. This is a deliberate feature in case you
  237. forget to choose an SRAM save location and do not wish to lose your position.
  238. (If you wish to open this directory then push F12 and type:
  239. *Filer_OpenDir <Wimp$ScrapDir>
  240. then push <Return> twice).
  241.  
  242. Whilst a game is being played the contents of the "SRAM Storage" box become
  243. unavailable. This is because it does not make sense to change the SRAM whilst
  244. a game is playing. If you wish to copy an existing file then this may be done
  245. using normal filer operations (files are not left 'open' in the desktop).
  246.  
  247. Filetypes
  248. ~~~~~~~~~
  249. The filetypes used have not been allocated by Acorn and are in the user area.
  250. They are:
  251. 0AD - SegaGG   - Sega Game Gear game
  252. 0AE - SegaMS   - Sega Master System game
  253. 0AF - SegaSRAM - Sega SRAM save file
  254.  
  255. Other types are also defined, but are not used in the current version.
  256.  
  257.  
  258. -----------------------------------------------------------------------------
  259.  
  260. 4) MasterGear
  261. ~~~~~~~~~~~~~
  262. Marat Fayzullin is a prolific author of emulators, as you will observe for
  263. yourself if you connect to his WWW pages at:
  264. http://www.freeflight.com/fms/
  265.  
  266. Some of these are value-for-money shareware products, but the majority are
  267. freely available, with Marat very kindly providing C source code for them.
  268. It is from this source code that I have compiled this Acorn version of the
  269. emulator, and added the various version-specific features described in the
  270. preceeding sections. The name of this emulator on other platforms is
  271. MasterGear, but this won't fit within Acorn's "pling-plus-nine-characters"
  272. application name limit, so I had to rename it "!Sega". You can go direct
  273. to Marat's MasterGear home page by connecting to:
  274. http://www.freeflight.com/fms/MG/
  275.  
  276. This is a port of version 1.00 of Marat's emulator. Marat knows of the
  277. following problems with this version of the emulator:
  278.  
  279.   GP Rider             - The road sometimes gets distorted. Garbage when
  280.                          selecting the motorcycle. Use -delay to fix it,
  281.                          at least partially.
  282.   XMen                 - Use -vperiod 7500.
  283.   Altered Beast        - Restarts at the title. Use -vperiod 8500.
  284.   Dynamite Headdy      - Screen sometimes blinks. Use -vperiod 10000. 
  285.   Galaxy Force         - Some garbage at the top of a screen in the
  286.                          Green World.
  287.   Alex Kidd Lost Stars - Palette gets reset to zeroes.
  288.   Surfing Ninjas       - Garbage at the title screens.
  289.   Sonic Drift 2        - Screen sometimes blinks.
  290.   Mickey Mouse GG      - Some problems after being killed in the
  291.                          second level.
  292.   Mahjong GG           - Distorted screen.
  293.   Astro Warrior        - Remains of blown cannons are distorted.
  294.  
  295. The fixes referred to can be set by selecting the relevant 'patch game'
  296. options in the front-end [not implemented in the current version], or by
  297. entering the values into the front-end configuration panels [not implemented
  298. in the current version].
  299.  
  300.  
  301. -----------------------------------------------------------------------------
  302.  
  303. 5) Known bugs in this version
  304. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  305. * Sound is not perfect yet - the sound-chip emulation is only partial (this
  306.   is a bit of an understatement, actually!)
  307.  
  308. * If the emulator can't change mode due to the mode it wants not being
  309.   defined you might get a funny flash before the desktop continues (this is
  310.   because it actually has to run through the emulator loop once to get back
  311.   to the point where it returns to the desktop). I can fix this by doing the
  312.   mode check before continuing, rather than from the core emulator code
  313.   itself.
  314.  
  315. * Full-screen mode has no speed limiting
  316.  
  317. * Allow for both 50Hz (PAL) and 60Hz (NTSC) versions of Master System games;
  318.   all games are run at 60Hz at the moment, unless full-screen when no speed
  319.   limiting is applied.
  320.   
  321. * Clicking <Select> or <Adjust> when redefining the keys causes the 'Press a
  322.   key' window to reopen sometimes if you have the pointer over the underlying
  323.   icon which was clicked on to open the 'Press a key' window
  324.   
  325. * Still accepts SRAM loads even whilst options are all greyed out during a
  326.   game! (Whoops...) [Doesn't matter, since it's ignored until you kill the
  327.   game and start a new one]
  328.  
  329.  
  330. -----------------------------------------------------------------------------
  331.  
  332. 6) History
  333. ~~~~~~~~~~
  334. Major version history follows. Some beta-test releases are omitted, but
  335. incorporated into major version change details.
  336.  
  337. New to version 0.71:
  338. * Fixed bug which meant that if you double-clicked a game before first
  339.   running !Sega the sound didn't work
  340.  
  341. New to version 0.70:
  342. * Full desktop SRAM support added, as described in section (4) above
  343. * Warning before trying to play files with unknown filetypes or an unknown
  344.   or absent file extension
  345.  
  346. New to version 0.60:
  347. * Implemented key redefinition, with a nice desktop front-end. Mouse-buttons
  348.   can also be used
  349. * Double-clicking a game without !Sega loaded now allows game to be paused
  350.   correctly (bug fix)
  351. * Sound system settings are now restored when returning to desktop (not just
  352.   when 'killing' game)
  353. * Master System full-screen mode now works, but I've doubled the vertical
  354.   size because I had it wrong before - which was why it didn't work ;-)
  355. * Now flushes keyboard buffer on return to desktop
  356.  
  357. New to version 0.50:
  358. * Different sound support, using logarithms and other nice stuff that
  359.   generate rounding errors in C (so it's not quite right, even though I
  360.   use a look-up table to try and make it more accurate). It's hard to tell
  361.   how well it works due to my not having a StrongARM (since sounds will be
  362.   cut off completely differently if the emulator were to run faster). Thanks
  363.   to Dave Walker at Acorn for finding out the frequency conversion
  364.   information.
  365.  
  366. New to version 0.40:
  367. * Sound support, albeit incorrect and with no noise
  368. * Full MS joypad 2 support
  369.  
  370. New to version 0.30:
  371. * Full-screen operation
  372. * Pause game and return to desktop
  373. * Integrated emulator/front-end
  374. * Minor front-end redesign
  375.  
  376. New to version 0.20:
  377. * Redesigned front-end with configuration windows (inactive, however!)
  378.  
  379. Verion 0.10
  380. * Initial release
  381.  
  382.  
  383. -----------------------------------------------------------------------------
  384.  
  385. 7) Copyright and Disclaimer
  386. ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  387. This emulator is copyright Marat Fayzullin 1994-6, and the Acorn-specific
  388. components are copyright Gareth Moore 1996-7. You may not attempt to pass off
  389. any part of this work as your own, although you may distribute it freely as
  390. long as you supply the complete archive (that is, all the files supplied to
  391. you).
  392.  
  393. This software is supplied "as is". I make no claims about the reliability or
  394. suitability for any purpose of this emulator, and any use of it is undertaken
  395. at your own risk. No responsibility is taken for any failure of the software,
  396. or for any loss or damage caused directly or indirectly by the software.
  397.  
  398. Whilst I will endeavour to help you if you have problems with this emulator,
  399. no such support is guaranteed.
  400.  
  401. In the above "This emulator" refers to everything supplied within this
  402. archive, which is specifically the !Sega application and all the files
  403. contained within it, and also the documentation files (including the one you
  404. are reading now).
  405.  
  406.  
  407. -----------------------------------------------------------------------------
  408.  
  409. If you wish to contact me then please email me at glm20@cam.ac.uk. If this
  410. email address does not work then find out my current address by connecting
  411. to my web pages (address below). It will certainly be in use up to and
  412. including August 1997.
  413.  
  414. Alternatively, you may write to me using the address:
  415.  
  416.       Gareth Moore,
  417.       Downing College,
  418.       Cambridge,
  419.       CB2 1DQ
  420.  
  421. Or find out my current email address from my WWW pages:
  422.  
  423.  
  424.  
  425. THE LONGEST RUNNING REGULARLY UPDATED ACORN WWW MAGAZINE: 32-bit Acorn Gaming
  426.                                            http://www.doggysoft.co.uk/gaming/
  427.  
  428.